home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Fritz: All Fritz
/
All Fritz.zip
/
All Fritz
/
FILES
/
GRAPTIES
/
MB111.LZH
/
MBTUTOR.DOC
< prev
next >
Wrap
Text File
|
1989-01-21
|
30KB
|
599 lines
MAGIC BRUSH
Version 1.11
Tutorial
Copyright (C) 1988, 1989 by Nassib Nassar, SoftBrush
Member, Association of Shareware Professionals
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
TUTORIAL
Version 1.10
Please read the README, README.2, README.3, and README.4 files (type
README). * CAUTION: Do NOT run SNAPSHOT before reading those files *
The following tutorial is intended to allow you to start using MAGIC
BRUSH right away. It is not intended to replace the Magic Brush
Reference Manual, which you should consult for detailed information,
and for many features that cannot be covered in a quick tutorial.
This tutorial will guide you, step by step, through various commands
in order to acquaint you with the mode of operation of the program.
After you go through it, please read the Reference Manual in order to
be able to fully utilize all the features of MAGIC BRUSH, MAGIC SHOW,
SNAPSHOT, and MB.TP provided as part of Magic Brush.
1. Run Magic Brush Load MAGIC BRUSH: type MB and press ENTER
2. Cursor movement The cursor appears in the middle of the screen.
To move the cursor, press one of the eight
cursor keys (on the numeric keypad) in the
desired direction. If the cursor does not
respond, it may be that Num Lock is "on": press
the Num Lock key once to set the keypad in the
cursor mode. Each press of a cursor key moves
Cursor lost? the cursor one pixel. If you lose the cursor,
press [H] to put it in the center of you screen
(if that fails, perhaps you inadvertently
changed its color to the background color: try
pressing the + key on the numeric keypad to
change pen color.
3. Pen down, Press [Ins] for PEN DOWN. Now moving the
pen up cursor will allow you to draw freehand. For
PEN UP, press [Del].
4. Cursor interval Press 5 (at the top of the keyboard). Press a
cursor key: the cursor moves five pixels. You
can chose any cursor INTERVAL from 1 to 10.
This allows you to move quickly over the
screen, and also to move by equal increments or
draw lines of equal length.
5. Help Screen Press function key F1. The on-line Help Screen
is displayed. This shows the MAGIC BRUSH
commands arranged in fairly logical groupings,
within the space limitations of the screen.
Under the section marked ** Colors: you can
Pen color see that [+] will change PEN COLOR. While
displaying the Help Screen, press [+]; the
drawing screen returns and the cursor color is
changed. If you move the cursor with PEN DOWN,
you will draw in the new color. Notice that
you can enter your commands directly from the
Help Screen, which makes it a "quasi menu".
Press [+] several times; the cursor cycles
- 1 -
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
through four colors, including the background
color (cursor invisible).
6. Pen thickness With PEN UP ([Del]), select a (visible) PEN
COLOR ([+]). Press Ctrl-T and enter 3 <CR> to
choose a pen THICKNESS of 3. Press [Ins]), and
move the cursor to draw.
7. Erase screen Clear the screen by pressing Ctrl-Home.
Undo Now press [U] to restore it. [U], in many
cases "undoes" the last operation if no
intervening keys are pressed (see Reference
Manual for list of operations that can be
reversed with [U]). Make sure pen is up ([Del])
and clear the screen again to start afresh.
8. Paint Select PEN COLOR cyan ([+]), and pen THICKNESS
4 (Ctrl-T). Select PEN DOWN ([Ins]), and draw
a polygon or any figure that is fully enclosed.
Select PEN UP, and move the cursor inside the
figure. To paint the inside of the figure
magenta, first select PEN COLOR magenta (([+]),
and press [P]. Enter the number that
corresponds to the the color of the border (1,
in this case, since the polygon sides are cyan)
followed by <CR>. The figure will be painted
magenta. Note that painting is with the
currently selected PEN COLOR and the paint
spreads from the cursor location to the
"border" of the color you specified. If paint
"leaks", that would be because either your
figure was not completely enclosed, or you
entered the wrong number corresponding to the
border color: press [U], make sure your figure
is completely enclosed, then repeat the
operation. (If, under certain conditions, you
encounter other difficulties, please refer to
the Reference Manual for a more complete
explanation).
9. Lines To draw Lines between any two points on the
screen, the ends of the lines must first be
Mark points Marked: select PEN UP, place the cursor at the
beginning of the desired line, press [M] to
Mark the point (notice the word "Marked"
flashes in the top left corner of the screen to
confirm that a point was marked). Mark the end
of the desired line ([M]). Select PEN COLOR
([+]), and press [L] to draw the line. Mark
another point, and press [L] to continue the
line. Or mark two new points and draw a line
between them. Press [U] to remove the last
line you have just drawn.
- 2 -
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
10. Rectangle Clear the screen (Ctrl-Home). To draw a box or
a Rectangle, Mark first the upper left corner,
next Mark the lower right corner of the
Rectangle. Press [R] to draw a Rectangle.
Change PEN COLOR ([+]), and press [R] to change
its color. Change pen color again, and press
[F] to Fill it with chosen PEN COLOR. Change
pen color again and press [R] to draw a border
(rectangle) around the filled rectangle.
11. Circle Clear the screen if you like (Ctrl-Home).
center Press [C] to draw a circle, its center
& radius will be the first point marked (top left corner
of the Rectangle drawn above) and the circle
will pass through the second marked point.
Notice that the old marked points remain until
replaced with new points (see Magic Brush
Reference Manual for a complete discussion
Circle, of marked points). Now try to press [D]. A
diameter circle will be drawn whose diameter lies on the
two marked points. Thus to draw a circle when
you specify its diameter, mark the two points
defining the diameter and press [D].
12. Cut & Paste Draw any figure. Mark ([M]) the upper left
corner first, then the lower right corner of a
rectangle that contains the figure you want to
cut. To see the exact location of the marked
points and the rectangle that they define,
Status press and hold [Alt]. The screen now shows two
Status lines (at the top and the bottom)
indicating the current status of many of the
program parameters. The center section of the
screen shows the exact location of the marked
points surrounded by two small circles, and a
diagonal line joining the marked points.
Cut, Release the [Alt] key and press [\] to cut the
Paste marked area. Move the cursor to a new
Paste modes location, and press [/] to paste. Pasting can
be done in TRANSPARENT, OPAQUE, or MERGE modes
(selected by pressing Ctrl-\ . Try pasting
using the three modes. Once cut, the figure
stays in memory until a new figure is cut (or
until you exit the program); it can therefore
be pasted repeatedly (please refer to the
Reference Manual for detailed explanation and
many more features of the paste function).
Flipping Press Ctrl-V: you will hear a ticking sound as
the program flips the figure you had cut
vertically; when the ticking sound ceases,
paste again (Ctrl-/). Try Ctrl-H (horizontal
90 degree flip) in a similar manner. Ctrl-D flips along
rotation a diagonal. Combining diagonal, horizontal,
and vertical flips allows you to rotate the cut
figure 90 degrees.
- 3 -
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
13. Text To add Text, choose PEN COLOR ([+]), then press
[T] and write your text followed by <CR>. Only
one line of text can be entered. Text entered
can now be pasted at the cursor position by
pressing [/]. Multiple lines can be entered
and pasted, one at a time. Any figure you had
previously cut will no longer be in memory (it
will be replaced by the text you entered).
14. Plot With PEN UP, you can draw or PLOT one point at
a time by pressing [`]. The size of the point
is determined by the pen THICKNESS (Ctrl-T).
15. Spray Pressing [*] selects SPRAY mode ON or OFF.
Select SPRAY ON, and with PEN DOWN you can
"spray paint". You can experiment with
different PEN COLORs on the same area. The
Spray size width of the spraY can be selected by pressing
Spray burst Ctrl-Y. Try PLOTting in SPRAY mode: this
provides very good control since it sprays in
single bursts.
16. Writing Pictures can be Written (saved) to a disk file
to disk by pressing Alt-W. You should enter a file
name. The program adds an extension .MB to the
name.
17. Reading A MAGIC BRUSH picture file can be Read (loaded)
from disk and displayed on the screen by pressing Alt-R
and entering the name of the file.
18. Symbols Draw a figure, mark it, and cut it. Save it on
your disk as a "symbol": press Alt-XW and enter
a file name (MAGIC BRUSH will add an extension
of .SB). Erase the screen (Ctrl-Home) and draw
another figure, cut it, and paste it somewhere
else on the screen. Now read the "symbol" file
by pressing Alt-XR. It is now "cut" and can be
pasted on the screen ( / ).
19. Second You can display another screen on which you can
screen draw by pressing [F6]. You can quickly toggle
between the two screens using [F6]. You can
cut from one screen and paste on the other.
(Please see the Reference Manual, particularly
with reference to the relationship of marked
points on the two screens.)
20. Libraries You can display successively a number of
picture libraries that are included on your
disk by pressing [F7] ([F8] displays them in
reverse sequence). You can cut a figure from
one of these library screens and paste it on
your drawing screen. You can make your own
library screens which you can then access using
[F7] and [F8] (see Reference Manual for details).
- 4 -
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
21. Exiting To exit Magic Brush, press Ctrl-End. Be
program sure to Write (Alt-W) your work to disk before
you exit. Magic Brush reminds you to do so if
you have made changes to either of your drawing
screens and you have not saved these changes
before exiting.
22. Palette To change the color palette you are using,
press [Q]. Pressing [Q] repeatedly allows you
to cycle through the four palettes available on
the CGA adapter. You can specify which palette
you would like MAGIC BRUSH to normally be in
(see the Reference Manual).
23. Background Press [B] repeatedly to cycle through all
color background colors. [V] allows you to cycle
background colors in the opposite direction.
See the Reference Manual if you would like to
always start MAGIC BRUSH with a background
color different from black-- however black or a
background color that is not one of the palette
colors is strongly recommended when drawing
(see Reference Manual for a discussion of this
point).
24. Other Experiment. Make use of the help screen
features to try out various commands and features. See
the Reference Manual for detailed description of
commands, configuration (including use of mouse or
joystick), displaying your drawings with MAGIC
SHOW, hints, etc.
25. Printing MAGIC BRUSH does not, at present, have a printing
routine. You can print your picture if you have
a dot-matrix printer compatible with the IBM
Graphics Printer (includes many Epson printers and
other printers that emulate them). To do so, you
must first load GRAPHICS.COM from your DOS disk,
then run Magic Brush, load a picture, and press
Alt-P. Other graphics screen dump programs are
available that offer more versatility and that
support various printers.
-------------------------
IBM Graphics Printer is a registered trademark
of International Business Machines
Corporation.
Epson is a registered trademark of Epson
Corporation.
- 5 -
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
A Note from the Author of Magic Brush
-------------------------------------
My experience with computers began in 1981 when I was nine years old.
For Christmas that year, my dad bought a SINCLAIR ZX81 computer. I
learned BASIC on the Sinclair with the help of my dad.
I then "graduated" to a Commodore 64. The Commodore's powerful
graphics capabilities encouraged me to begin writing programs that
used these capabilities. I wrote several graphics drawing programs
that allowed the user to sketch figures and paint them.
In 1985, when I was 14, we got an IBM PC. MAGIC BRUSH was my first
large program on the IBM PC. The program, written in BASICA, grew in
size and became unwieldy, and I was encouraged to use a compiled
language. So my dad bought Turbo Pascal, which I learned sufficiently
to rewrite Magic Brush in its present form. I also added MAGIC SHOW
and other ancillary programs which I am distributing as part of the
Magic Brush package and that I hope you will find useful. Magic Brush
is, therefore, the result of several years of learning and hard work
in between school and other activities. I hope that you will find it
helpful in some way. If you do find it useful and use it on a regular
basis, I hope that you will consider sending in your registration fee,
and encourage your friends to copy the program (but not the manual,
please) and send their registration fees! The fees will help me, at
the very least, in buying disks, books, printer supplies and software,
and may even help with the cost of my future college education.
I would like to continue to improve the program and to add new
features to make it competitive with other similar programs as my
programming and math get better, and as I receive your suggestions and
support. I already have a number of important improvements in mind
that I will be working on. I will, of course, notify registered users
of new versions of the program when they become available.
I would like to thank Mr. Jeffrey H. Johnson for explaining to me
(among other things) pointers in Pascal. My younger brother, Karim
(13 years), contributed a lot to the program: he suggested the name
MAGIC BRUSH, and he drew the pictures and libraries supplied with the
program and used in the demo (MBDEMO). My dad, Rashid, helped write
the manual. Both Karim and my dad pointed out bugs and offered many
suggestions for improving the program.
Nassib Nassar
(SoftBrush)
September, 1988
(modified January, 1989)
- 6 -
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
Magic Brush History:
Version 1.01 corrects a few errors in version 1.00:
1. When you typed the name of a non-existent MB file on the command
line, you had to clear the screen.
2. When you enter text, you no longer lose previously marked points.
3. In version 1.00 of MAGIC SHOW, PAUSE paused about 0.02 seconds
depending on the the computer. In version 1.01 PAUSE pauses for
1 ms, and is independent of the speed of the computer.
4. The License conditions were added to the README file and to
MBTUTOR.DOC.
Version 1.02: circle routine is faster at aspect ratio of 1.00.
Version 1.10:
1. Added ability to read and write part of screen as a "symbol" file.
2. Added diagonal flipping of cut.
3. Added ability to center a figure to be pasted (F2, F4).
4. Modified Software License and opening program information screen.
Version 1.11:
1. Corrected error that caused MAGIC BRUSH to crash when trying to
calibrate joystick if disk was full.
2. Modified README file & added ASP OMBUDSMAN statement.
- 7 -
MAGIC BRUSH TUTORIAL Copyright (C) 1988,89 Nassib Nassar, SoftBrush
DISCLAIMER OF WARRANTY
THIS SOFTWARE AND DOCUMENTATION ARE SOLD "AS IS" AND WITHOUT
WARRANTIES AS TO PERFORMANCE OR MERCHANTABILITY. THESE PROGRAMS
ARE SOLD WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES WHATSOEVER. THE
USER IS ADVISED TO TEST THE PROGRAMS THOROUGHLY BEFORE RELYING ON
THEM. THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAMS.
ANY LIABILITY OF SELLER OR MANUFACTURER WILL BE LIMITED EXCLUSIVELY
TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE PRICE.
SOFTWARE LICENSE
MAGIC BRUSH, MAGIC SHOW, SNAPSHOT, MB.TP, and MBDMO are Copyright (C)
1988,1989 by Nassib Nassar, SoftBrush. All Rights Reserved. You may
use, copy, and distribute this software provided that all of the
following conditions are satisfied:
- The software is distributed complete and without any modification,
addition, or omission, including all text and ancillary files.
- No part of the Reference Manual is copied or distributed in any
form.
- No fee is charged for copying or distributing the software, except
that a reasonable fee, not exceeding $7.00, may be charged to cover
copying, mailing, and diskette costs. The provider of such copying
or distribution services shall make it explicitly clear, in writing,
to all receivers of such service that any fees charged for such
service only cover the costs of the service and do not constitute
registration of the software or any remuneration to the author of
the software.
- The software is not distributed through any BBS that charges or
requires payment for, or whose connect time includes a charge for,
downloading files (this does not apply to BBS's that have connect-
time charges or a one-time or periodic subscription charges but do
not have additional charges for downloading files).
- The software is not distributed as part of or in conjunction
with any other software package, or in conjunction with or as part
of or installed on any computer or hardware system, without the
express prior written permission of the author.
To print the ORDER/REGISTRATION form on your printer, please place the
Magic Brush diskette in drive A: and type: COPY A:REGFORM PRN
and press Enter.
- 8 -
Magic Brush
REGISTRATION / ORDER FROM
Please send order form with check or money order to:
Nassib Nassar
4035 Livingstone Pl.
Durham, NC 27707
Name: ______________________________________
Company:______________________________________
Address:______________________________________
______________________________________
City: ___________________ State:___________ Zip:____________
0107
==================================================================
|Quantity Description Unit Extended |
|---------|----------------------------------|--------|----------|
| | Magic Brush Program & Manual* | $25.00 | |
|---------|----------------------------------|--------|----------|
| | Magic Brush Manual only* | $20.00 | |
|---------|----------------------------------|--------|----------|
| | Magic Brush Trial diskette only**| $ 7.00 | |
|---------|----------------------------------|--------|----------|
| |
| Subtotal $ |
| NC residents please add Sales Tax $ |
| |
| Total $ |
|----------------------------------------------------------------|
* Includes registration.
** Does not include registration
Prices subject to change without notice.
Magic Brush will be shipped post free within the continental
U.S.A.
Please indicate diskette size:
___ 5.25" diskette ___ 3.5" diskette